package com.ruoyi.system.mapper;

import java.util.List;
import com.ruoyi.system.domain.SchoolStudent;
import com.ruoyi.system.domain.vo.SchoolStudentVo;
import com.ruoyi.system.domain.vo.TransferData;

/**
 * 学生信息Mapper接口
 * 
 * @author ruoyi
 * @date 2025-06-29
 */
public interface SchoolStudentMapper 
{
    /**
     * 查询学生信息
     * 
     * @param id 学生信息主键
     * @return 学生信息
     */
    public SchoolStudent selectSchoolStudentById(Long id);

    /**
     * 查询学生信息列表
     * 
     * @param schoolStudent 学生信息
     * @return 学生信息集合
     */
    public List<SchoolStudent> selectSchoolStudentList(SchoolStudent schoolStudent);

    /**
     * 新增学生信息
     * 
     * @param schoolStudent 学生信息
     * @return 结果
     */
    public int insertSchoolStudent(SchoolStudent schoolStudent);

    /**
     * 修改学生信息
     * 
     * @param schoolStudent 学生信息
     * @return 结果
     */
    public int updateSchoolStudent(SchoolStudent schoolStudent);

    /**
     * 删除学生信息
     * 
     * @param id 学生信息主键
     * @return 结果
     */
    public int deleteSchoolStudentById(Long id);

    /**
     * 批量删除学生信息
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteSchoolStudentByIds(Long[] ids);

    /**
     * 查询学生信息列表(带班级信息)
     *
     * @param schoolStudent 学生信息
     * @return 学生信息集合
     */
    public List<SchoolStudentVo> selectSchoolStudentVoList(SchoolStudent schoolStudent);


    /**
     * 根据班级id查询班级下所有学生的id
     * @param id
     * @return
     */
    public List<Long> selectStudentIdsByClassId(Long id);

    /**
     * 获取没有班级和本班级下所有学生的信息
     * @param id
     * @return
     */
    List<TransferData> selectNoClassAndThisClassStudentsInfo(Long id);

    /**
     * 删除本班学生
     * @param classId
     */
    void deleteThisClassStudents(Long classId);

    //给本班学生添加新的学生
    void addStudentsInThisClass(List<Long> ids, Long classId);
}
